package com.palace.saw.module.app.service.articlecategory;

import com.palace.saw.framework.common.pojo.PageResult;
import com.palace.saw.module.app.controller.admin.articlecategory.vo.ArticleCategoryPageReqVO;
import com.palace.saw.module.app.controller.admin.articlecategory.vo.ArticleCategorySaveReqVO;
import com.palace.saw.module.app.dal.dataobject.articlecategory.ArticleCategoryDO;
import jakarta.validation.Valid;

/**
 * 文章分类 Service 接口
 *
 * @author saw
 */
public interface ArticleCategoryService {

    /**
     * 创建文章分类
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createArticleCategory(@Valid ArticleCategorySaveReqVO createReqVO);

    /**
     * 更新文章分类
     *
     * @param updateReqVO 更新信息
     */
    void updateArticleCategory(@Valid ArticleCategorySaveReqVO updateReqVO);

    /**
     * 删除文章分类
     *
     * @param id 编号
     */
    void deleteArticleCategory(Long id);

    /**
     * 获得文章分类
     *
     * @param id 编号
     * @return 文章分类
     */
    ArticleCategoryDO getArticleCategory(Long id);

    /**
     * 获得文章分类分页
     *
     * @param pageReqVO 分页查询
     * @return 文章分类分页
     */
    PageResult<ArticleCategoryDO> getArticleCategoryPage(ArticleCategoryPageReqVO pageReqVO);

}